Python小白学习笔记第3课:Python编码规范(2024版)

211次阅读
没有评论

共计 1873 个字符,预计需要花费 5 分钟才能阅读完成。

Python 小白学习笔记第 2 课:Python 运行环境搭建(2024 版)

在上一节课中,我们完成了第一个 Python 程序,学会了如何在交互模式和命令行模式下运行 Python 代码,但距离真正的写 Python 代码还有一段距离。

为了防止写出来的 Python 代码在运行时报各种语法格式错误,我们需要先学习下 Python 编码规范。

注释

注释最大的作用是提高程序的可读性,没有注释的程序简直就是天书,让人吐血!

注释是给人看的,Python 解释器会忽略掉注释,也就是说,注释在随源代码进入预处理器或编译时会被移除,不会在目标代码中保留也不会影响程序的执行结果。

所以说,在编码过程中,注释必不可少,Python 中有单行注释与多行注释:

  • 单行注释:以 # 开头的部分
  • 多行注释:三个引号开头,三个引号结尾
# 这是单行注释
print("hello, world")  # 也可以写这里

"""
这是多行注释
在这里可以随便写
"""
print("goodbye, world")

注意:三个连续引号,其实是定义了一个字符串。因为没有变量指向,会被当做垃圾回收。

TODO 注释

在单行注释 #后面添加 TODO 关键字,能够高亮显示注释,少量的 TODO 注释可以起到提醒的作用:

# TODO 后面要完成的功能
print("hello, world")

头部注释

第一行以 #号开头的就是头部注释,也叫神奇的注释。这些神奇的注释总是出现在文件顶部,提供解释器或编码信息。

这些注释不仅仅是给读者看的,也是给操作系统看的,这些注释决定了系统将如何运行文件,常见的头部注释有两个:

#!/usr/bin/env python
# -*- coding: utf-8 -*-
print("hello, world")

定义 #! 会去找指定路径下的 Python 解释器;定义 coding 告诉系统脚本是何编码格式。

类型提示

Python 通过类型提示提供了可选的静态类型支持,执行 Python 脚本时,类型提示被视为注释,解释器会自动忽略。

类型提示使用冒号来分隔参数和变量的名称与类型,对于返回值,类型提示使用箭头 -> 分隔 def 语句的闭合括号和类型。

# int 表示整数类型
num: int = 10

# 类型提示 n 参数需要整数值,返回值是字符串
def func(n: int) -> str:
    return str(n)

缩进风格

Python 程序依靠代码块的缩进来体现代码之间的逻辑关系,缩进不正确会导致程序运行错误。

虽然没有明确规定缩进几个空格或者制表符,但严禁两者混用并且数目必须统一,要么都用空格缩进,要么都用制表符缩进。通常以 4 个空格或制表符(Tab 键)为基本的缩进单位,并保持所有缩进都一致。

name = " 张三 "  # 不缩进

if name == " 张三 ":
    print(" 我是 ")  # 缩进 4 个空格
    print(" 张三 ")  # 缩进 4 个空格

行连接符

一行代码长度是没有限制的,但为了可读性更强,通常将一行比较长的代码分为多行显示。这时可以使用 \ 行连接符,把它放在行结束的地方,Python 解释器会将它们解释为同一行代码。

this = "\
优美胜于丑陋,\
明了胜于晦涩,\
简洁胜于复杂,\
复杂胜于凌乱,\
扁平胜于嵌套,\
间隔胜于紧凑,\
可读性很重要。"

print(this)

不过,每行代码最好不要超过 80 个字符,如果超过,建议使用小括号将多行内容隐式的连接起来,而不推荐使用反斜杠 \ 进行连接。

区分大小写

Python 是区分大小写的,这意味着在编写 Python 代码时,大小写字母是有区别的。所以,一定要小心不要犯大小写错误,因为它们可能会导致代码出现错误。

name = " 张三 "
Name = " 李四 "

print(name)  # 结果为:张三
print(Name)  # 结果为:李四

命名规范

  • 只能包含字母、数字、下划线
  • 不能以数字开头
  • 不能包含关键字,见名知意

包 / 模块的命名规范:使用小写字母命名,如果有多个单词,则用下划线分隔。正确命名方式:lower_with_under。

类的命名规范:使用驼峰法命名,如果有多个单词,则首字母大写,私有类用下划线开头。正确命名方式:HelloWorld 和_HelloWorld。

函数 / 变量的命名规范:使用小写字母命名,如果有多个单词,则用下划线分隔,私有函数 / 变量用下划线开头。正确命名方式:lower_with_under 和_lower_with_under。

常量的命名规范:全部使用大写字母命名,如果有多个单词,则用下划线分隔,私有常量用下划线开头。正确命名方式:CAPS_WITH_UNDER 和_CAPS_WITH_UNDER。

Python 小白学习笔记第 4 课:Python 变量和数据类型(2024 版)

正文完
 0
阿伯手记
版权声明:本站原创文章,由 阿伯手记 于2024-01-11发表,共计1873字。
转载说明:本站原创内容,除特殊说明外,均基于 CC BY-NC-SA 4.0 协议发布,转载须注明出处与链接。
评论(没有评论)
验证码

阿伯手记

阿伯手记
阿伯手记
喜欢编程,头发渐稀;成长路上,宝藏满地
文章数
766
评论数
204
阅读量
449076
今日一言
-「
热门文章
职场救急!AI请假话术生成器:1秒定制高通过率理由

职场救急!AI请假话术生成器:1秒定制高通过率理由

超级借口 不好开口?借口交给我!智能生成工作请假、上学请假、饭局爽约、约会拒绝、邀约推辞、万能借口等各种借口理...
夸克网盘快传助手提高非VIP下载速度

夸克网盘快传助手提高非VIP下载速度

夸克网盘限速这个大家都知道,不开会员差不多限速在几百 K。那有没有办法在合法合规途径加速下载夸克网盘呢?这里推...
国内已部署DeepSeek模型第三方列表 免费满血版联网搜索

国内已部署DeepSeek模型第三方列表 免费满血版联网搜索

本文收集了目前国内已部署 DeepSeek 模型的第三方列表,个个都是免费不限次数的满血版 DeepSeek,...
巴别英语:用美剧和TED演讲轻松提升英语听力与口语

巴别英语:用美剧和TED演讲轻松提升英语听力与口语

还在为枯燥的英语学习而烦恼吗?巴别英语通过创新的美剧学习模式,让英语学习变得生动有趣。平台提供海量美剧和 TE...
Chinese Name Generator 在线中文姓名生成器

Chinese Name Generator 在线中文姓名生成器

Chinese Name Generator 是一款在线中文姓名生成器,可在几秒内生成符合个人需求的中文名字。...
TVAPP:开源电视盒子资源库,一键打造家庭影院

TVAPP:开源电视盒子资源库,一键打造家庭影院

导语 TVAPP 是一个专为 Android TV 电视盒子用户打造的开源影音资源库,集成了影视、直播、游戏等...
2025年12月 每日精选

2025年12月 每日精选

关于每日精选栏目 发现一些不错的资源,点击 这里 快速投稿。 12 月 26 日 .ax 顶级域 目前全球唯一...
最新评论
15220202929 15220202929 怎么用
八对 八对 麻烦大佬更新下【堆新】的友链站名:八对星星描述:极目星视穹苍无界•足履行者大地有疆链接:https://8dui.com图标:https://cf.8dui.com/logo.webp横标:https://cf.8dui.com/logo-w.webp订阅:https://8dui.com/rss.xml
三毛笔记 三毛笔记 已添加
DUINEW DUINEW 已添加贵站,期待贵站友链~博客名称:堆新博客地址:https://duinew.com/博客描述:堆新堆新,引力向新!——堆新(DUINEW)博客头像:https://d.duinew.com/logo.webp横版头像:https://d.duinew.com/logo-w.webp博客订阅:https://duinew.com/rss.xml
hedp hedp 没看懂
bingo bingo 直接生成就可以啦,也可以添加一些选项
满心 满心 申请更新下友联信息,原名:满心记,现名:周天记原域名:qq.mba,现域名:zhoutian.com描述:我在人间混日子
开业吉日 开业吉日 没看明白这个怎么用
开业吉日 开业吉日 beddystories 这个网站太赞了,收藏
热评文章
夸克网盘快传助手提高非VIP下载速度

夸克网盘快传助手提高非VIP下载速度

夸克网盘限速这个大家都知道,不开会员差不多限速在几百 K。那有没有办法在合法合规途径加速下载夸克网盘呢?这里推...
清华大学官方免费DeepSeek教程

清华大学官方免费DeepSeek教程

AI 领域近期最引人注目的焦点当属 DeepSeek,这款由中国创新企业深度求索研发的人工智能工具,正以开放源...
Short-Link 免费开源短网址程序,基于Fastify、Vercel和Supabase构建

Short-Link 免费开源短网址程序,基于Fastify、Vercel和Supabase构建

Short-Link 是一款基于 Fastify、Vercel 和 Supabase 构建的 URL 缩短服务...
国内已部署DeepSeek模型第三方列表 免费满血版联网搜索

国内已部署DeepSeek模型第三方列表 免费满血版联网搜索

本文收集了目前国内已部署 DeepSeek 模型的第三方列表,个个都是免费不限次数的满血版 DeepSeek,...
Chinese Name Generator 在线中文姓名生成器

Chinese Name Generator 在线中文姓名生成器

Chinese Name Generator 是一款在线中文姓名生成器,可在几秒内生成符合个人需求的中文名字。...
BeddyStories 完全免费儿童睡前故事库,让孩子随时随地入睡更轻松

BeddyStories 完全免费儿童睡前故事库,让孩子随时随地入睡更轻松

BeddyStories 是一个致力于为儿童提供优质睡前故事的在线平台,用户可以在这里找到来自世界各地的经典故...
DrawLink:一键生成链接视觉卡片,提升分享点击率

DrawLink:一键生成链接视觉卡片,提升分享点击率

小贴士 :此站或已变迁,但探索不止步。我们已为您备好「类似网站」精选合集,相信其中的发现同样能为您带来惊喜。